home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / dgbtrs.z / dgbtrs
Text File  |  1996-03-14  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. DDDDGGGGBBBBTTTTRRRRSSSS((((3333FFFF))))                                                          DDDDGGGGBBBBTTTTRRRRSSSS((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      DGBTRS - solve a system of linear equations  A * X = B or A' * X = B with
  10.      a general band matrix A using the LU factorization computed by DGBTRF
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE DGBTRS( TRANS, N, KL, KU, NRHS, AB, LDAB, IPIV, B, LDB, INFO )
  14.  
  15.          CHARACTER      TRANS
  16.  
  17.          INTEGER        INFO, KL, KU, LDAB, LDB, N, NRHS
  18.  
  19.          INTEGER        IPIV( * )
  20.  
  21.          DOUBLE         PRECISION AB( LDAB, * ), B( LDB, * )
  22.  
  23. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  24.      DGBTRS solves a system of linear equations
  25.         A * X = B  or  A' * X = B with a general band matrix A using the LU
  26.      factorization computed by DGBTRF.
  27.  
  28.  
  29. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  30.      TRANS   (input) CHARACTER*1
  31.              Specifies the form of the system of equations.  = 'N':  A * X = B
  32.              (No transpose)
  33.              = 'T':  A'* X = B  (Transpose)
  34.              = 'C':  A'* X = B  (Conjugate transpose = Transpose)
  35.  
  36.      N       (input) INTEGER
  37.              The order of the matrix A.  N >= 0.
  38.  
  39.      KL      (input) INTEGER
  40.              The number of subdiagonals within the band of A.  KL >= 0.
  41.  
  42.      KU      (input) INTEGER
  43.              The number of superdiagonals within the band of A.  KU >= 0.
  44.  
  45.      NRHS    (input) INTEGER
  46.              The number of right hand sides, i.e., the number of columns of
  47.              the matrix B.  NRHS >= 0.
  48.  
  49.      AB      (input) DOUBLE PRECISION array, dimension (LDAB,N)
  50.              Details of the LU factorization of the band matrix A, as computed
  51.              by DGBTRF.  U is stored as an upper triangular band matrix with
  52.              KL+KU superdiagonals in rows 1 to KL+KU+1, and the multipliers
  53.              used during the factorization are stored in rows KL+KU+2 to
  54.              2*KL+KU+1.
  55.  
  56.      LDAB    (input) INTEGER
  57.              The leading dimension of the array AB.  LDAB >= 2*KL+KU+1.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DDDDGGGGBBBBTTTTRRRRSSSS((((3333FFFF))))                                                          DDDDGGGGBBBBTTTTRRRRSSSS((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      IPIV    (input) INTEGER array, dimension (N)
  75.              The pivot indices; for 1 <= i <= N, row i of the matrix was
  76.              interchanged with row IPIV(i).
  77.  
  78.      B       (input/output) DOUBLE PRECISION array, dimension (LDB,NRHS)
  79.              On entry, the right hand side matrix B.  On exit, the solution
  80.              matrix X.
  81.  
  82.      LDB     (input) INTEGER
  83.              The leading dimension of the array B.  LDB >= max(1,N).
  84.  
  85.      INFO    (output) INTEGER
  86.              = 0:  successful exit
  87.              < 0: if INFO = -i, the i-th argument had an illegal value
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.